home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / source.lha / Geomview / src / lib / mg / mg.attr < prev    next >
Encoding:
Text File  |  1991-09-22  |  3.8 KB  |  111 lines
  1.             MG context attributes
  2.  
  3.             mbp  Tue Sep 17 21:39:28 1991
  4.  
  5.  
  6. Attribute        Set Value        Get Value
  7. ---------        ---------        ---------
  8.  
  9.  
  10. MG_SHOW            int visible        int *visible
  11. -------            -----------        ------------
  12. Set: visible = 1 means the context's window should be made visible if
  13.      it is not already, and visible = 0 means the window should be
  14.      made to disappear.  When a context is created, the default value
  15.      for MG_SHOW is 1, which causes the window to appear in the call
  16.      to mgctxcreate.  To prevent this, you must explicity set MG_SHOW
  17.      to 0, and then use mgctxset to set MG_SHOW to 1 when you want the
  18.      window to appear.
  19. Get: visible = 1 means window is currently visible; 0 means it is
  20.      currently not visible.
  21.  
  22.  
  23. MG_APPEAR        Appearance *ap        Appearance **ap
  24. ---------        --------------        --------------
  25. Set: app is a pointer to an Appearance structure as returned by
  26.      ApCreate.  app is copied into the current context and becomes the
  27.      current appearance.  This is a deep copy.  This is equivalent to
  28.          mgsetappearance(ap, MG_SET).
  29. Get: *ap is set to point to the current appearance.  This should NOT
  30.      be modified in any way!
  31.  
  32.  
  33. MG_ApSet        <attribute-list>    NA
  34. ---------        ----------------    --
  35. Set: <attribute-list> is a list of AP_ attribute-value pairs, as
  36.      to ApSet(), terminated by AP_END. These attributes are merged into
  37.      the current appearance.  This is equivalent to
  38.     ap = ApCreate( <attribute-list> );
  39.     mgsetappearance(ap, MG_MERGE);
  40.     ApDelete(ap);
  41. Get: Not gettable.
  42.  
  43.  
  44. MG_WINDOW        WnWindow *win        WnWindow **win
  45. ---------        -------------        --------------
  46. Set: win is a pointer to a WnWindow structure as returned by
  47.      WnCreate().  This window becomes the context's window.
  48. Get: *win is set to point to the context's window structure.
  49.  
  50.  
  51. MG_WinSet        <attribute-list>    NA
  52. ---------        ----------------    --
  53. Set: <attribute-list> is a list of WN_ attribute-value pairs, as to
  54.      WnSet(), terminated by WN_END.  These attributes are applied to
  55.      the context's window.  This is equivalent to calling WnSet(win,
  56.      <attribute-list>), where win is a pointer to the context's
  57.      window.
  58. Get: Not gettable.
  59.  
  60.  
  61. MG_CAMERA        Camera *cam        Camera **cam
  62. ---------        -----------        ------------
  63. Set: cam is a pointer to Camera structure as returned by CamCreate().
  64.      This camera becomes the context's camera.
  65. Get: *cam is set to point to the context's camera structure.
  66.  
  67.  
  68. MG_CamSet        <attribute-list>    NA
  69. ---------        ----------------    --
  70. Set: <attribute-list> is a list of CAM_ attribute-value pairs, as to
  71.      CamSet(), terminated by CAM_END.  These attributes are applied to
  72.      the context's camera.  This is equivalent to calling CamSet(cam,
  73.      <attribute-list>), where cam is a pointer to the context's
  74.      camera.
  75. Get: Not gettable.
  76.  
  77.  
  78. MG_PARENT        mgcontext *ctx        mgcontext **ctx
  79. ---------        --------------        ---------------
  80. Set: ctx is the ctx of the parent window.  May be used in some heirarchal
  81.      window systems.
  82. Get: *ctx is set to point to the ctx of the parent window.
  83.  
  84.  
  85. MG_SETOPTIONS        int optionmask        int *optionmask
  86. -------------        --------------        ---------------
  87. Set: optionmask should be a bitwise "or" (|) of any the following:
  88.        MGO_DOUBLEBUFFER
  89.        MGO_HIDDEN
  90.        MGO_BACKFACECULL
  91.        MGO_INHIBITBACKGROUND
  92.        MGO_INHIBITCLEAR
  93.        MGO_INHIBITSWAP
  94.      The corresponding options are turned on.
  95. Get: *optionmask is set to a bitwise "or" (|) of all currently enabled
  96.      options.
  97.  
  98.  
  99. MG_UNSETOPTIONS        int optionmask        int *optionmask
  100. ---------------        --------------        ---------------
  101. Set: exactly analogous to MG_SETOPTIONS, except that the options in
  102.      optionmask are turned off.
  103. Get: (same as with MG_SETOPTIONS)
  104.  
  105.  
  106. MG_BACKGROUND        ColorA *color        ColorA *color
  107. -------------        -------------        -------------
  108. Set: *color becomes the context's background color.  A private
  109.      internal copy of *color is kept.
  110. Get: The context's background color is copied to *color.
  111.